OLA 文档中心

主题

2026-08-20

关闭日志系统 - LogShutdown ​

函数简介 ​

关闭日志系统并释放资源。

接口名称 ​

LogShutdown

DLL调用 ​

c
int32_t LogShutdown(int64_t instance, int64_t loggerHandle);

参数说明 ​

参数名类型说明
instance长整数型OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
loggerHandle长整数型日志实例句柄（0 表示默认实例）。

示例 ​

写完日志后 LogShutdown(0) 关闭默认实例并释放资源。

SDK 调用 ​

cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
const int64_t logger = 0; // 默认实例

ola.LogInfo("shutting down");
ola.LogFlush(logger);
int ret = ola.LogShutdown(logger);
if (ret != 1) {
    return;
}
// 此后不应再对该 logger 写日志
csharp
using System;
using OLAPlug;

var ola = new OLAPlugServer();
long logger = 0;

ola.LogInfo("shutting down");
ola.LogFlush(logger);
int ret = ola.LogShutdown(logger);
if (ret != 1) return;
// 此后不应再对该 logger 写日志
python
from OLAPlugServer import OLAPlugServer

ola = OLAPlugServer()
logger = 0

ola.LogInfo("shutting down")
ola.LogFlush(logger)
ret = ola.LogShutdown(logger)
if ret != 1:
    raise RuntimeError("failed")
# 此后不应再对该 logger 写日志
java
import com.olaplug.OLAPlugServer;

OLAPlugServer ola = new OLAPlugServer();
long logger = 0;

ola.LogInfo("shutting down");
ola.LogFlush(logger);
int ret = ola.LogShutdown(logger);
if (ret != 1) {
    return;
}
// 此后不应再对该 logger 写日志
go
import "github.com/ola/olaplug/olaplug"

ola, _ := olaplug.NewOLAPlugServer("OLAPlug_x64.dll")
defer ola.ReleaseObj()
logger := int64(0)

ola.LogInfo("shutting down")
ola.LogFlush(logger)
ret := ola.LogShutdown(logger)
if ret != 1 {
    return
}
// 此后不应再对该 logger 写日志
rust
use olaplug::OLAPlugServer;

let ola = OLAPlugServer::new("OLAPlug_x64.dll").unwrap();
let logger = 0i64;

ola.log_info("shutting down");
ola.log_flush(logger);
let ret = ola.log_shutdown(logger);
if ret != 1 {
    return;
}
// 此后不应再对该 logger 写日志
cpp
var ola = com("OlaPlug.OlaSoft")
var logger = 0

ola.LogInfo("shutting down")
ola.LogFlush(logger)
var ret = ola.LogShutdown(logger)
if(ret == 1) {
    // 此后不应再对该 logger 写日志
}
vbscript
Set ola = CreateObject("OlaPlug.OlaSoft")
logger = 0

ola.LogInfo "shutting down"
ola.LogFlush logger
ret = ola.LogShutdown(logger)
If ret = 1 Then
    ' 此后不应再对该 logger 写日志
End If
text
.局部变量 ola, OLAPlug
.局部变量 ret, 整数型
.局部变量 logger, 长整数型

ola.Create ()
logger ＝ 0

ola.LogInfo (“shutting down”)
ola.LogFlush (logger)
ret ＝ ola.LogShutdown (logger)
.如果真 (ret ＝ 1)
    ' 此后不应再对该 logger 写日志
.如果真结束
aardio
import OLAPlugServer;
var ola = OLAPlugServer();
var logger = 0;

ola.LogInfo("shutting down");
ola.LogFlush(logger);
var ret = ola.LogShutdown(logger);
if(ret == 1){
    // 此后不应再对该 logger 写日志
}
text
变量 ola <类型 = OLAPlugServer>
ola = 新建 OLAPlugServer
长整数 logger = 0

ola.LogInfo("shutting down")
ola.LogFlush(logger)
整数 ret = ola.LogShutdown(logger)
如果真 (ret ＝ 1)
{
    ' 此后不应再对该 logger 写日志
}
cpp
#include "OLAPlugServer.h"

OLAPlugServer ola;
int64_t logger = 0;

ola.LogInfo("shutting down");
ola.LogFlush(logger);
int32_t ret = ola.LogShutdown(logger);
if (ret != 1) {
    return;
}
// 此后不应再对该 logger 写日志

原生 DLL 调用 ​

cpp
long instance = CreateCOLAPlugInterFace();
long logger = 0;

LogInfo(instance, "shutting down");
LogFlush(instance, logger);
int ret = LogShutdown(instance, logger);
csharp
using System.Runtime.InteropServices;

[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern long CreateCOLAPlugInterFace();
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogInfo(long ola, string message);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogFlush(long ola, long loggerHandle);
[DllImport("OLAPlug_x64.dll", CallingConvention = CallingConvention.StdCall)]
static extern int LogShutdown(long ola, long loggerHandle);

long instance = CreateCOLAPlugInterFace();
long logger = 0;

LogInfo(instance, "shutting down");
LogFlush(instance, logger);
int ret = LogShutdown(instance, logger);
python
from ctypes import CDLL, c_int, c_int64

ola = CDLL("OLAPlug_x64.dll")
ola.CreateCOLAPlugInterFace.restype = c_int64
instance = ola.CreateCOLAPlugInterFace()
logger = 0

ola.LogInfo(instance, b"shutting down")
ola.LogFlush(instance, logger)
ret = ola.LogShutdown(instance, logger)

返回值 ​

返回值说明
1成功。
0失败。

注意事项 ​

项目说明
关闭后关闭后，下次写入日志时会自动重新初始化。
关闭前会自动刷新所有缓冲区中的日志关闭前会自动刷新所有缓冲区中的日志。
关闭后会释放所有相关资源（文件句柄、内存等）关闭后会释放所有相关资源（文件句柄、内存等）。
不建议频繁调用不建议频繁调用，会影响性能。